Array.splice()

Доступность

Flash Player 5.

Синтаксис

my_array.splice(start:Number, deleteCount:Number [, value0:Object, value1...valueN]) : Array

Параметры

start Индекс элемента в массиве, откуда начинается добавление и/или/ удаление.

deleteCount Количество удаляемых элементов, включая элемент, определенный в параметре start. Если параметр deleteCount не задан, метод удаляет все элементы, начиная с элемента с индексом start , и заканчивая последним элементом массива . Если значение параметра - 0, элементы не удаляются.

value Одно или более значений, добавляемых в массив элементов, начиная с индекса, определенного в параметре start.

Возвращает

Элементы, удалённые из массива.

Описание

Метод; добавляет /или удаляет/ элементы в массив. Метод изменяет массив, не делая его копию.

Пример

Пример создания массива, с последующим применением метода splice, использующего индекс 1, как параметр start. Удаляются все элементы массива, начиная со второго. Остаётся только элемент с индексом 0 исходного массива :

var myPets_array:Array = new Array("cat", "dog", "bird", "fish");
trace( myPets_array.splice(1) ); // dog,bird,fish
trace( myPets_array ); // cat

Пример создания массива, с последующим применением метода splice, использующего индекс 1, как параметр start и число 2, как параметр deleteCount. Здесь удаляюся два элемента массива, начиная со второго. Остаются первый и последний элемент исходного массива :

var myFlowers_array:Array = new Array("roses", "tulips", "lilies", "orchids");
trace( myFlowers_array.splice(1,2 ) ); // tulips,lilies
trace( myFlowers_array ); // roses,orchids

Пример создания массива, с последующим применением метода splice, использующего индекс 1, как параметр start , число 0, как параметр deleteCount и строку chair, в качестве параметра value. Здесь ничего не удаляется, а напротив, добавляется строка chair , в качестве элемента с индексом 1 :

var myFurniture_array:Array = new Array("couch", "bed", "desk", "lamp");
trace( myFurniture_array.splice(1,0, "chair" ) ); // выводится empty array 
trace( myFurniture_array ); // выводится couch,chair,bed,desk,lamp

Посмотреть комментарии LiveDocs

Предыдущая | Следующая | Оглавление